Using a text editor, the Sound
Object parameter data are written into the mks4agb.ini file that was placed in the Working Directory. Please set these up as written in this color. (In the mks4agb.ini file, text coming after a semicolon (;) to the end of the line is a comment.) If you have proceeded through the set up as described in the tutorial, then all you need to do is set things up as described below, and you should have no problems. The "Explanation" links connect to descriptions of each of the parameters. * Note: The use of double-byte characters will generate system errors upon execution, so please avoid double-byte characters. (This includes double-byte spaces.) * A set up file is available that has all of the parameters already set up. If writing in the parameters is too much trouble, you can download the mks4agb.ini file at the bottom of the page and use it. |
INDEX Writing the Set Up
File (mks4agb.ini) (1) Rebuild Switch (2) Waveform Data Input Directory (3) Song Data Input Directory (4) Source File Directory (5) Output Directory (6) AGB System Library File Directory (7) GCC Execution Path (8) Initial Setup Values for Sound Modes (9) Starting Tone Color Group Setup (10) Tone Color Setup (11) Key Split Table Setup (12) Sound 3 Waveform Setup (13) Music Player Setup (14) Song Setup (15) MIDI Input Performance Setup (16) Memory Access Area Size (17) Maximum Lines for Processing Time of m4aSoundMain() (18) DMA Limit Switch (19) System ROM Use Switch |
Rebuild SwitchSet to 0. (Explanation) rebuild = 0 |
Waveform Data Input DirectoryThis specifies the directory for the Waveform Data File (Explanation) aif_dir = aiff\ |
Song Data Input DirectoryThis specifies the directory for the Song Data File. (Explanation) mid_dir = midi\ |
Source File DirectoryThis specifies the directory for Source Files that are output. (Explanation) src_dir = src\ |
Output DirectoryThis specifies the directory for Sound Objects that are output. (Explanation) out_dir = out\ |
AGB System Library File DirectoryThis specifies the directory for the library files installed with the Game Boy Advance Developer Toolkit 2.0. (Explanation) agb_lib = C:\agb\lib |
GCC Execution PathThis is the execution path for the GCC compiler. Please use the following two: (Explanation) cmd_path=C:\Program
files\Cygnus\thumbelf-000512\H-i686-cygwin32\bin |
Initial Setup Values for Sound ModesUse the values specified in the defaults. They are: mode_i = 8, 13, 21024, 8 |
Starting Tone Color Group SetupIn the tutorial demonstration, three Tone Color Groups are set up. vgroup = 0 |
Tone Color SetupThis sets up the Tone Colors corresponding to the MIDI Program Change Numbers. vgroup = 0 p000 = A, gun, 99, 99, 99, 99 p001 = A, se3, 99, 99, 99, 99 p002 = A, se5, 99, 99, 99, 99 p003 = A, se8, 99, 99, 99, 99 p004 = A, se9b, 99, 99, 99, 99 p005 = A, flutec4, 99, 99, 99, 99 p006 = Q, sc2dt12, 99, 99, 99, 99 p007 = Q, sc1dt50, 99, 99, 99, 99,,,,1c p008 = Q, sc2dt50, 99, 99, 99, 99 p009 = Q, sc1dt50, 99, 99, 99, 99,,,,1c p010 = Q, sc4st15, 99, 99, 99, 99 p011 = A, suboscc3, 99, 99, 99, 99 p012 = A, orgc3, 99, 99, 99, 99 p016 = Q, sc2dt12, 99, 66, 00, 99 p017 = A, synbsc2, 99, 99, 99, 80 p018 = A, brassc3, 99, 99, 99, 80 p019 = A, mutetpc4, 99, 99, 99, 80 p020 = A, cutgtg3, 99, 99, 99, 99 p021 = A, sawg3, 99, 99, 99, 99 p022 = A, sinec3, 99, 99, 99, 99 p023 = A, revcym, 99, 99, 99, 99 p024 = S, 0, 2, c1 p025 = S, 1, 2, c1 p026 = A, engin01a, 99, 99, 99, 99 p027 = Q, sc3w001, 99, 99, 99, 99 p127 = R, 1, c1 vgroup = 1 p000 = F, housebd, 99, 99, 99, 99, 60 ;C1 p001 = F, housesd, 99, 99, 99, 99, 60 ;C#1 p002 = F, housechh, 99, 99, 99, 99, 60 ;D1 p003 = F, houseohh, 99, 99, 99, 99, 60 ;D#1 p004 = F, tamba, 99, 99, 99, 99, 60 ;E1 p005 = F, vibra, 99, 99, 99, 99, 60 ;F1 p006 = F, timbale, 99, 99, 99, 99, 60 ;F#1 p007 = F, se8, 99, 99, 99, 99, 60 ;G1 vgroup = 2 p000 = A, harpc3, 99, 99, 99, 40 p001 = A, harpc5, 99, 99, 99, 40 You may view the content of the parameters in the Sound Driver Manual by means of the "Explanation" link. |
Key Split Table SetupThis registers the Key Split Table Numbers. In the Tutorial Demonstration, a number of Key Split Tone Colors are used. Set them up as shown below. (Explanation) ; C1, C#1,D1. D#1,E1, F1, F#1,G1, G#1,A1,A#1, B1, t000 = 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, ;C1-B1 ; C2, C#2,D2. D#2,E2, F2, F#2,G2, G#2,A2,A#2, B2, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, ;C2-B2 ; C3, C#3,D3. D#3,E3, F3, F#3,G3, G#3,A3,A#3, B3, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, ;C3-B3 ; C4, C#4,D4. D#4,E4, F4, F#4,G4, G#4,A4,A#4, B4, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, ;C4-B4 ; C5, C#5,D5. D#5,E5, F5, F#5,G5, G#5,A5,A#5, B5, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, ;C5-B5 ; C6, C#6,D6. D#6,E6, F6, F#6,G6, G#6,A6,A#6, B6, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01 ;C6-B6 t001 = 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, ;C1-B1 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, ;C2-B2 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00, ;C3-B3 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, ;C4-B4 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, ;C5-B5 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01, 01 ;C6-B6 |
Sound 3 Waveform SetupThis sets up the Sound 3 Waveforms. A number of Tone Colors that use Sound 3 are used in the Tutorial Demonstration. Set them up as shown below. (Explanation) w000 = 0011235689ACDEEFFFEEDCA986532110, sinewave w001 = 0123456789ABCDEFFEDCBA9876543210, triangle w002 = FFEEDDCCBBAA99887766554433221100, fat_saw w003 = FEDCBA99888888887777777766543210, thin_saw w004 = FFFF0000000000000000000000000000, square12 w005 = FFFFFFFF000000000000000000000000, square25 w006 = FFFFFFFFFFFF00000000000000000000, square37 w007 = FFFFFFFFFFFFFFFF0000000000000000, square50 |
Music Player SetupThis specifies the Music Player used during a game and the number of tracks that can be played back. Four Music Players are used in this Tutorial Demonstration. Set them up as shown below. (Explanation) mp00 = 8 mp01 = 6 mp02 = 2 mp03 = 2 |
Song SetupThis sets up the Song Data. The numbers specified here are used when starting songs or sound effects by number. By setting each parameter, it is possible to specify priority, etc. Many songs are used in the Tutorial Demonstration. Set them up as shown below. (Explanation) s001 = se_d01, 3, 0, 127, 10 ; Direct Single Event s002 = se_dbend, 3, 0, 127, 10 ; Direct + Pitch Bend + Single Event s003 = se_dvib, 3, 0, 60, 10 ; Direct + Vibrato + Single Event s004 = se_gbend2, 3, 0, 90, 10 ; Compatible + Pitch Bend + Single Event s005 = se_swep2, 3, 0, 90, 10 ; Compatible + Sweep + Single Event s006 = se_noise, 3, 0, 127, 10 ; Compatible + Noise + Single Event s007 = sound3, 3, 0, 127, 10 ; Compatible Sound 3 s008 = se_dben2, 3, 0, 127, 10 ; Direct + Pitch Bend + Continuous s009 = se_gbend, 3, 0, 90, 10 ; Compatible + Pitch Bend + Continuous s010 = se_sweep, 3, 0, 127, 10 ; Compatible + Sweep + Continuous s011 = se_dgmix, 3, 0, 127, 10 ; Direct + Compatible (Mixed) s013 = agb2000, 2, 0, 127, 20, 50 ; AGB 2000!! s014 = wario, 0, 0, 100, 0, 50 ; s015 = engin, 3, 0, 127, 10 ; Engine Sound (Loop) You may view the content of the parameters in the Sound Driver Manual by means of the "Explanation" link. |
MIDI Input Performance SetupUse the values specified in the defaults. They are: pbymidi = 0, 0, 120, 200, 120 |
Memory Access Area SizeUse the value set up as the default. (Explanation) memacc_s = 16 |
Maximum Lines for Processing Time of m4aSoundMain()You can set a limit for the processing time in the sound main routine. max_line = 0 |
DMA Limit SwitchUse the value specified in defaults. (Explanation) only_dma1 = 0 |
System ROM Use SwitchUse the value set as the default. (Explanation) sys_rom = 0 |
The mks4agb.ini is the setup file that is required for sound creation in this
system. When actually using the system, please be sure to read the Details which are linked to each of the categories (Explanation). A mks4agb.ini file with the above settings can be downloaded below. * Download a Sample Setup File (IniFile.zip 4KB) |
This concludes the settings for the mks4agb.ini file. Please proceed to the next
section. Next: Running mks4agb.exe |
[ | Back | User's
Manual Table of Contents | Tutorial Table of Contents | Next | ]